home *** CD-ROM | disk | FTP | other *** search
/ Super Shareware Collection / Super Shareware Collection.iso / sound / sbbeep.zip / SBBEEP.DOC < prev    next >
Text File  |  1994-03-12  |  6KB  |  121 lines
  1. mmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmm
  2.                           Sound Blaster Beep
  3.                              SBBEEP  v1.0
  4.                                   by
  5.                          * NeoSphere Software *
  6.  
  7.                             March 12, 1994
  8. mmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmmm
  9.  
  10. Overview:
  11.    -purpose
  12.    -inventory
  13.    -usage
  14.    -the SBBEEP challenge
  15.    -bugs
  16.    -programming notes
  17.    -next version
  18.    -getting in touch
  19.    -warranty
  20.  
  21. PURPOSE:
  22. =======
  23.      I wrote SBBEEP as a simple tool for anybody that is getting sick of
  24.    the annoying PC speaker's beep (take a hammer to it). This program is very
  25.    simple and straight forward. It emits a tone from your SB (Adlib compatible)
  26.    for 500 milliseconds. An example of how SBBEEP could be useful is to stick
  27.    it into some batch file (that's about the only thing it's useful for). It's
  28.    a lot louder then a plain speaker beep (about 47 dB). Perhaps you could put
  29.    it in the last line in your AUTOEXEC.BAT so you can here a gentle (yet loud)
  30.    tone when your computer is all warmed up. The possibilities are ENDLESS!!!
  31.    Another important factor in this program is its size. It's tiny! A little
  32.    bit under 4 KB (3980 bytes)! It should be small too but it wasn't at first
  33.    (more on that in the 'Programming Notes' section). So here it is SBBEEP!
  34.    I hope you enjoy!
  35.  
  36. INVENTORY:
  37. =========
  38.      Here is a list of the original files that came with this package. If any
  39.    of these files are missing, extra files are added, or sizes are different,
  40.    PLEASE do not redistribute this package. 
  41.  
  42.           SBBEEP.ZIP      5970 bytes    The ZIP containing the files below.
  43.               |
  44.           SBBEEP.COM      3980 bytes    This is the beeper!
  45.           SBBEEP.DOC      5702 bytes    The file you are reading.
  46.           TEST.BAT         248 bytes    Batch file to compare beeps.
  47.           README.BAT        45 bytes    Displays this document.
  48.  
  49. USAGE:
  50. =====
  51.      The syntax and usage of SBBEEP is very simple. Just type 'SBBEEP'.
  52.    If you don't have a Adlib/Sound Blaster compatible sound card you shouldn't
  53.    hear anything and downloading this was a total waste of time for you. But
  54.    otherwise your speakers should beeeeeep.
  55.  
  56. THE SBBEEP CHALLENGE:
  57. ====================
  58.      Take the 'SBBEEP Challenge'! This is a short test that will hopefully
  59.    prove to you that SBBEEP sounds a little bit better than a standard DOS
  60.    beep. Simply type 'TEST' and follow the directions. If you're not convinced
  61.    just delete this package or put it in deep storage.
  62.  
  63. BUGS:
  64. ====
  65.      I don't know of any bugs yet. I know there is a short aftertone after the
  66.    beep. But that's about it. If you do find a bug please feel free to report
  67.    it to me (read 'Getting in Touch' later on for more info).
  68.  
  69. PROGRAMMING NOTES:
  70. =================
  71.      SBBEEP was programmed by me, Travis Gebhardt, in Borland C++. I learned
  72.    how to emit tones from the SB by reading 'Programming the Adlib/Sound
  73.    Blaster FM Music Chips v2.0' by Jeffrey S. Lee (jlee@smylex.uucp), a very
  74.    good document that I downloaded recently. My first compile left me at about
  75.    18 kb. Pretty big for a simple task. I changed memory models from small to
  76.    tiny which brought the size down to 7 kb. I changed the TINY .exe to a .com
  77.    by using EXE2BIN. That lowered the size to 4416 bytes. I eliminated some
  78.    functions that I only used once (because SBBEEP is so simple and small),
  79.    optimized my variables (two bytes used during board detection), and just
  80.    basically tweaked it out. The final INCREDIBLE size is 3980 bytes! Free
  81.    source code is available at request (only C++).
  82.  
  83. NEXT VERSION:
  84. ============
  85.      SBBEEP v1.00 was meant to be a bare minimum. So naturally there is room
  86.    for improvement (at the cost of size, which I tried to reduce the most in 
  87.    this version). Some things I'm thinking about adding are: variable sustain
  88.    length and variable frequency which would both be command line features.
  89.    Any other great ideas, just send'em in.
  90.  
  91. GETTING IN TOUCH:
  92. ================
  93.      To get in touch with me (please give any comments/criticism) just mail me
  94.    at one of the following addresses:
  95.  
  96.           America Online  -   Trav
  97.  
  98.           Internet        -   trav@aol.com
  99.  
  100.           Snail Mail      -   Travis Gebhardt
  101.                               42502 SE Oral Hull Road
  102.                               Sandy, OR 97055 
  103.  
  104. WARRANTY:
  105. ========
  106.      Just to make sure I don't get sued or anything for a beeper causing
  107.    deafness. This package (consisting of the original files described in the
  108.    'Inventory' section above) is provided on an "as-is" basis, and its author
  109.    makes no warranty or representation, express or implied, with respect to 
  110.    its quality performance of fitness for a particular purpose. In no event
  111.    will the author of this package be liable for direct, indirect, special,
  112.    incidental, or consequential damages arising out of the use or inability to
  113.    use the programs/information contained within this package. Use of this
  114.    package is at your own risk.
  115.  
  116.      This package ('SBBEEP.ZIP') may be used and copied freely so long as no
  117.    modifications are made to the files contained within. No money shall be
  118.    charged for its distribution beyond reasonable shipping, handling and
  119.    duplication costs, nor shall proprietary changes be made to this package so
  120.    that it cannot be distributed freely. This package may not be included in
  121.    catalogs or commercial packages without the written consent of its author.